Path: / v310 / appliance / {uuid}

Path parameters:
uuid - Appliance Tintri UUID

Resources
NameDescription
action=testEmailDeprecated. Tests alert mail.
action=testSNMPDeprecated. Send a SNMP test trap to a remote trap receiver host.
action=testSyslogForwardingDeprecated. Send a test log forwarding message to the remote host.
action=upgradeDeprecated. Starts the Tintri appliance upgrade.
alertCountsGets the number of notifications on appliance
certificateReturns any present host certificate and trusted Certificate Authority (CA) certificates.
componentGets the Tintri appliance components.
connectivity
connectivity/testPing
Ping test.
controllerGets the Tintri appliance controllers.
csiPropertiesGets CSI properties.
customizationInfoGets the Tintri appliance customization information, which includes replication interface and space saving support.
dataProtectionConfigReturns the Tintri appliance data protection config.
dateTimeReturns the date and time settings.
diskGets the Tintri appliance disks.
dnsGets the Tintri appliance DNS setting.
emailalertsGets the Tintri appliance alert email configuration.
enableEncryptionEnables disk encryption.
encryptionInfoGets the disk encryption information.
escalateDPAPrivilegesEscalates DATA_PROTECTION_ADMIN user's privilges until the time specific by escalatedPrivilegeExpiryTimeMs.
expandDeprecated. Expands the storage capacity of the Tintri appliance after successful HA failover, the additional capacity will be added to realstore's single large RAID group.
failedComponentsGets the failed hardware parts that need to be replaced.
fileDirInfo
fileDirInfo/{path}
Fetch the file system information associated with the entity specificed by path.
hafailoverAPI to perform HA failover.
infoGets the Tintri appliance basic information, which includes serial number, model name, OS verison, and product ID.
ipmiGets IPMI configuration.
ipsGets the Tintri appliance IP configurations.
lacpGets LACP configuration.
lldpReturns the LLDP info for both controllers.
maintenanceModeGets maintenance mode.
operationalStatusGets the Tintri appliance operational status, which contains sample time, up time, count of unread alerts, file system status, urgent message.
rbacExternalConfigReturns the external directory service authentication configuration.
rebootAPI to perform Appliance reboot operation
rebootSecondaryAPI to perform secondary reboot operation
restartAuthdRestart the AuthenticationService (authd).
restartDbRestarts the application database.
restartSnmpRestart the snmp-agent.
restartWebServerRestart the web server.
rotateEncryptionKeyRotates the disk encryption key.
rpcReportGenerates a report of external RPC connection to filesystem in /var/log/tintri/rpc-connections-external.txt
shutdownAPI to perform Appliance shutdown operation
snmpGets the sytem SNMP configuration.
snmpTargetGet all the SNMP trap targets information.
snmpUserGets SNMP users.
stagingAreaInfoGets the Tintri appliance staging area information, which includes details about the space, software uploaded etc.
supportGets the Tintri appliance autosupport settings.
syslogForwardingGets the log forwarding info.
temperatureGets the Tintri appliance termperatures.
testEmailTests alert mail.
testEncryptionTests disk encryption.
testRbacExternalConfigTest the external directory service authentication configuration.
testSNMPSend a SNMP test trap to a remote trap receiver host.
testSyslogForwardingSend a test log forwarding message to the remote host.
timezonesReturns list of all time zones supported by the server.
upgradeStarts the Tintri appliance upgrade.
upgradeInfoGets the Tintri appliance upgrade information, which includes upgrade state, checksum, verison, error message.

Method Summary
ResourceDescription
GET /v310/appliance/{uuid}Gets Tintri Appliance properties. The value 'default' should be used for {uuid} on VMstore server. Information about appliance operation, customization, upgrade, controllers, disks, temperatures, power, maintenance mode, disk encryption and redundancy is returned.
PUT /v310/appliance/{uuid}Updates Tintri appliance's specified properties. The value 'default' should be used for {uuid}. Tomcat should be restarted if appliance DNS, time zone or host certificate is updated for the VMstore. Restart Tomcat On TGC, only an ApplianceIp can be added on a VMStore, using this API. For any other specified property, an error will be returned. Also a VMStore's tintriUuid must be used for {uuid} property, on which the new ApplianceIp needs to be created for the SyncRepl configuration.

Method Detail
HTTP Example:
GET /v310/appliance/{uuid}

API Example:

ApplianceResource.getAppliance({'uuid': /* uuid Appliance Tintri UUID */});

Description:
Gets Tintri Appliance properties. The value 'default' should be used for {uuid} on VMstore server. Information about appliance operation, customization, upgrade, controllers, disks, temperatures, power, maintenance mode, disk encryption and redundancy is returned.
Tintri Api Server Support:
All
Query parameter Reference:
ApplianceFilterSpec
Output:
List<Appliance> - List of Appliance instances
Errors:
Error CodeMessageHTTP Response Code
ERR-API-8001Resource not found404
Produces:
application/json;qs=1, application/xml;qs=0.5
Consumes:
application/json;qs=1, application/xml;qs=0.5
HTTP Example:
PUT /v310/appliance/{uuid}

API Example:

ApplianceResource.updatePlatform({'uuid': /* uuid Appliance Tintri UUID */,
  '$entity': /* platformContainer The request contains properties to update */});

Description:
Updates Tintri appliance's specified properties. The value 'default' should be used for {uuid}. Tomcat should be restarted if appliance DNS, time zone or host certificate is updated for the VMstore. Restart Tomcat On TGC, only an ApplianceIp can be added on a VMStore, using this API. For any other specified property, an error will be returned. Also a VMStore's tintriUuid must be used for {uuid} property, on which the new ApplianceIp needs to be created for the SyncRepl configuration.
Tintri Api Server Support:
All
Input:
Request<Appliance> - The request contains properties to update
Output:
void
Errors:
Error CodeMessageHTTP Response Code
ERR-API-0103Error encountered while modifying properties.500
ERR-API-0201No entities found.400
Produces:
application/json;qs=1, application/xml;qs=0.5
Consumes:
application/json;qs=1, application/xml;qs=0.5